🔌 Plug into the tracker

This API service enables real-time programmatic access to the global AI regulation news data behind this tracker.

Search and retrieve the news updates for any given date and/or country under the following categories: Latest Macro Developments | Sector Developments | Bilateral & Multilateral Developments.

You can also search for items under the categories of Official Materials | Acts, Bills & Reforms | Guidelines, Frameworks & Standards | Executive & Regulatory Instruments (to the extent that category is available on the country's profile).

Use case ideas:

• Starting a newsletter of AI regulation updates within your organisation
• Creating your own private chatbot or news alert on AI regulation
• Building an educational website or public repository on AI regulation

Licence terms apply. See below.

---

⚡ Usage

See tutorial guide here: A data science approach to tracking AI regulation

Implementation via:

• Python - PyPI
• NodeJS - npm
• cURL

Values for "target_news" or "targetNews" parameters:

Parameter value	Corresponding title on the tracker
latest_news	Latest Macro Developments
sector_news	Sector Developments
bilateral_multilateral_news	Bilateral & Multilateral Developments
official_materials	Official Materials
acts_bills_reform	Acts, Bills & Reforms
orders_admin_regs	Executive & Regulatory Instruments | Executive Orders (US) | Measures, Provisions & Regulations (China)
guidelines_standards_frameworks	Guidelines, Frameworks & Standards

Values for the "market" (Python) or "countryCode" (NodeJS, cURL) parameter:

Supply a country's ISO code (e.g. AU, CN, US), a jurisdiction or regional bloc code (e.g. Europe for the European Union, ASEAN, OECD), or a US state code (e.g. US-CA for California). Use "global" to search across all jurisdictions at once. For the full list of every accepted code and its corresponding name — including all US states — in ready-to-copy array format, see the Country & market codes reference.

• Python
• NodeJS
• cURL

          
#Setup --- pip install techieray-ai-reg-tracker-api

#Import
from techieray_ai_reg_tracker_api import GlobalAIRegulationTrackerClient

#Initialise API
api_key = "###INSERT API KEY###"
client = GlobalAIRegulationTrackerClient(api_key)

#Search updates globally on a particular date
#example - get global updates dated 18 March 2025
response1 = client.call(market = "global", target_news = "", target_date ="2025-03-18")

#Search updates of a given category in a given country 
#example - get 'Latest Macro Developments' updates ("latest_news") in Australia ("AU") 
response2 = client.call(market = "AU", target_news = "latest_news", target_date = "")

#Search updates in a given country on a given date
#example - get updates on China ("CN") dated 18 December 2024 
response3 = client.call(market = "CN", target_news = "", target_date="2024-12-18")

#Search updates of a given category in a given country on a given date 
#example - get 'Latest Macro Developments' ("latest_news") updates in the United States ("US") dated 3 October 2024 
response4 = client.call(market = "US", target_news = "latest_news", target_date = "2024-10-03")

print(response1)
print(response2)
print(response3)
print(response4)
          
        

          
//Setup --- npm i techieray-ai-reg-tracker-api

//Import
const { GlobalAIRegulationTrackerClient } = require('techieray-ai-reg-tracker-api')

//Initialise API
const apiKey = "###INSERT API KEY###"
const client = new GlobalAIRegulationTrackerClient(apiKey)

//Search updates globally on a particular date
//example - get global updates dated 18 March 2025
const response1 = client.call(market = "global", targetNews = "", targetDate ="2025-03-18")

//Search updates of a given category in a given country 
//example - get 'Latest Macro Developments' updates ("latest_news") in Australia ("AU") 
const response2 = client.call(market = "AU", targetNews = "latest_news", targetDate = "")

//Search updates in a given country on a given date
//example - get updates on China ("CN") dated 18 December 2024 
const response3 = client.call(market = "CN", targetNews = "", targetDate="2024-12-18")

//Search updates of a given category in a given country on a given date 
//example - get 'Latest Macro Developments' ("latest_news") updates in the United States ("US") dated 3 October 2024 
const response4 = client.call(market = "US", targetNews = "latest_news", targetDate = "2024-10-03")

console.log(response1)
console.log(response2)
console.log(response3)
console.log(response4)
            
        

          
# Example 1: Search global updates on a particular date (2025-03-18)

curl -X POST \
  'https://globalairegtrackerapi-j66zxhj6dq-uc.a.run.app' \
  -H 'Content-Type: application/json' \
  -d '{
    "countryCode": "global",
    "targetNews": "",
    "targetDate": "2025-03-18",
    "apiKey": "###INSERT API KEY###"
  }'

# Example 2: Search 'Latest Macro Developments' updates in Australia ("AU")

curl -X POST \
  'https://globalairegtrackerapi-j66zxhj6dq-uc.a.run.app' \
  -H 'Content-Type: application/json' \
  -d '{
    "countryCode": "AU",
    "targetNews": "latest_news",
    "targetDate": "",
    "apiKey": "###INSERT API KEY###"
  }'

# Example 3: Search updates in China ("CN") dated 2024-12-18

curl -X POST \
  'https://globalairegtrackerapi-j66zxhj6dq-uc.a.run.app' \
  -H 'Content-Type: application/json' \
  -d '{
    "countryCode": "CN",
    "targetNews": "",
    "targetDate": "2024-12-18",
    "apiKey": "###INSERT API KEY###"
  }'

# Example 4: Search 'Latest Macro Developments' updates in the United States ("US") dated 2024-10-03

curl -X POST \
  'https://globalairegtrackerapi-j66zxhj6dq-uc.a.run.app' \
  -H 'Content-Type: application/json' \
  -d '{
    "countryCode": "US",
    "targetNews": "latest_news",
    "targetDate": "2024-10-03",
    "apiKey": "###INSERT API KEY###"
  }'
          
        

---

🔤 Language Support

To retrieve other data in other languages, specify the optional parameter "lang_code" (Python) or "langCode" (NodeJS, cURL) parameter in the relevant .call() method.

If lang_code / langCode is not specified (or omitted) from your .call() method, the API will default to English.

The API service currently supports English and Chinese (simplified). More languages will be added in the future.

Parameter value	Language
eng	English
chn	Chinese (simplified)

---

🔑 API key

Every request above needs a valid API key. Keys come with a subscription, and the same key also covers the MCP server, the AI search and the embed widget.

Prices, allowances and licence terms are all on the Plans & Pricing 💳 tab.

🤖 Connect the tracker to your AI assistant

The tracker is available as an MCP server. MCP (Model Context Protocol) is an open standard that lets AI assistants call external data sources directly.

Once connected, assistants such as Claude, Claude Code and Cursor can look up AI regulation in this tracker while answering you — instead of relying on training data that may be out of date or simply wrong. Ask “what are Japan's AI rules?” and the assistant queries the tracker and cites the source links.

Coverage is the same dataset that powers this page: 235 jurisdictions and 3,800+ tracked items, tagged across 70 topic, activity and sector labels.

---

🔗 Endpoint

MCP endpoint	https://mcp.techieray.com/mcp
Transport	Streamable HTTP (JSON-RPC 2.0)
Health check	https://mcp.techieray.com/health
Authentication	Optional. Send Authorization: Bearer <your API key> to unlock the paid tier.

---

🆓 Do you need a key?

No. The server works with no API key at all, and the free tier is designed to be genuinely useful: you always get the item titles and the official source URLs, so an assistant can point you to the primary material. A key raises the limits and unlocks the paragraph summaries and the tags.

The MCP server uses the same API keys as the API. If you already hold a tracker API key, it works here with no extra purchase — just send it as a Bearer token. The full free-vs-paid breakdown and the prices are on the Plans & Pricing 💳 tab.

---

⚡ Setup

Pick your client below. Leave the Authorization header out entirely if you just want the free tier.

If your client reports that the server “needs authentication”, the key being sent is invalid or has expired. An unrecognised key is rejected outright rather than quietly dropping you to the free tier — remove the header to use the free tier, or renew your key.

• Claude Code
• Claude Desktop
• Cursor
• cURL

          
# Free tier - no API key required
claude mcp add --transport http ai-reg-tracker https://mcp.techieray.com/mcp

# Paid tier - with your API key
claude mcp add --transport http ai-reg-tracker https://mcp.techieray.com/mcp \
  --header "Authorization: Bearer ###INSERT API KEY###"

# Confirm it connected
claude mcp list
          
        

          
# Easiest route:
#   Settings -> Connectors -> Add custom connector
#   URL: https://mcp.techieray.com/mcp
#
# Or edit claude_desktop_config.json directly:
#   macOS   ~/Library/Application Support/Claude/claude_desktop_config.json
#   Windows %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ai-reg-tracker": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.techieray.com/mcp",
        "--header",
        "Authorization: Bearer ###INSERT API KEY###"
      ]
    }
  }
}

# Free tier: delete the two "--header" / "Authorization" lines.
# Restart Claude Desktop after saving.
          
        

          
// ~/.cursor/mcp.json  (or .cursor/mcp.json inside a single project)

{
  "mcpServers": {
    "ai-reg-tracker": {
      "url": "https://mcp.techieray.com/mcp",
      "headers": {
        "Authorization": "Bearer ###INSERT API KEY###"
      }
    }
  }
}

// Free tier: remove the "headers" block entirely.
          
        

          
# Ask for a country summary (free - no key needed)

curl -s -X POST https://mcp.techieray.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_country_summary","arguments":{"country_code":"EU"}}}'

# Search across two countries with a tag filter (paid - needs a key)

curl -s -X POST https://mcp.techieray.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer ###INSERT API KEY###" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search_regulations","arguments":{
         "country_codes":["GB","US"],
         "categories":["Generative AI"],
         "max_results":3}}}'

# Responses stream back as server-sent events, so each JSON payload
# arrives on a line beginning with "data: ".
          
        

---

🛠️ Available tools

Your assistant picks these automatically — you rarely need to name them. Listed here so you know what the server can do.

Tool	What it does	Parameters
list_countries	Every jurisdiction held in the tracker, with its code. Fully free.	None
list_categories	Every tag you can filter by, across the topic, activity and sector facets. Fully free.	None
get_country_summary	A short bullet-point read on where a jurisdiction stands. Fully free.	country_code (required)
get_country_details	The full profile: headlines, acts and bills, regulator developments, official materials, international links.	country_code (required)
search_regulations	Search by country, tag or keyword. Tags must match exactly — call list_categories for valid values.	country_codes, categories, keyword, max_results (all optional)

Country codes are the same ones the API uses — an ISO code (AU, CN, US), a bloc (EU, ASEAN, OECD) or a US state (US-CA). The full list is on the Country & market codes reference page.

---

📄 Licence terms

The same terms that govern the API govern the MCP server, available here: Commercial Terms of Service.

Please keep the attribution the server returns with each response — Global AI Regulation Tracker (techieray.com/GlobalAIRegulationTracker) — when you reproduce or publish results.

🧩 Display the tracker on your own website

The Global AI Regulation Tracker is now available as a widget 🚀

You can now include the tracker as an <iframe> or <embed> element into the HTML of your website, dashboard, intranet page, etc.

The widget is basically a lightweight version of this tracker, with personal commentary and marks removed so that you can white-label and apply your own marks.

---

⚡ Usage

Simply add the below snippet into the HTML code of your website. You will need to insert your registered key at the [***INSERT REGISTERED KEY***] part. Without a valid key, the widget will not display. See "Register key" section below.

        
<div style=”border: 1px solid #ccc; border-radius: 8px;”>
<iframe src=”https://www.techieray.com/embed/GlobalAIRegulationTracker?id=[***INSERT YOUR REGISTERED KEY***]” title=”Global AI Regulation Tracker”></iframe>
</div>
          
        

---

🖥️ Demo

---

🔑 Register key

The widget is included with the Pro plan. There is no separate embed subscription: paste the same API key your Pro plan already gives you into the id parameter of the snippet above. The widget will not display on a Mini or Standard key.

Prices, allowances and licence terms are all on the Plans & Pricing 💳 tab.